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GENERAL DESCRIPILON 


SYSTEM/COMPARE is a utility program providing the ability to 
coapare pairs of files» printing and identifying by record nusber 
ald non"gatching record pairs. Such noneidenticai records are 
printed in EBCOIC and hexadeciaal representations with ali 
differing hexades (Cfour-bit hexadeciaal digits) flagged with an 
asterisk pointer character. The files to be compared may be on 
any coabination of disks cards or tape aedia. Shcuid both files 
be on disks a speciakl vaode of operation say be selected wherein. 
both files are compared sector-by~sector rather than 
record-by-records allowing maximum speed. Other features inciude 
the ability to cause automatic cessation of a comparison after a 
specified number of errors» toa interrogate the nusber of records 
currentiy processed» or to terminate a cogparison at witli. I f 
the files to be cosgpared have differing record tengths» 
SYSTEM/COMPARE emits a warning message and pads the shorter 
records with bianks. 
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OPERATING INSIBUCIIONS 
SYSTEM/COMPARE fs executed fron the sPo by the follouing message: 
EX SYSTEM/COMPARE | 


Input to the program may be provided in either of two ways. A 
user desiring to compare exactly one pair of files say execute 
the prograa and file-equate the desired files te internal file 
nases “A* and "8". The utility perforss the specified comparison 
and goes to £034. Use of SYSTEM/COMPARE in this “one cosgpare” 
wsode precludes the ability to use the sector-by-sector sacde of 
operation or to be abte to specify the amaxiraus nuaber of 
cosparison errors before termination (a defautt of 15 ts used). 
Shouid files A and B not te file~equateds the program processes 


coz@ands entered through the SPO. Input is requestec after each. 


pair of fites has been processed untii the prograe is terminated 
by a biank accept. The input syntax has been chosen to be 
Siailar to that of DMPALL to waxisize ease of use. 


Switch GO inforas SYSTEM/COMPARE of the nusber of characters on 
the user*®s print train or chain. This affects the EBCDIC 
printout of the data» as characters not printable based on this 
switch setting are translated to blanks. Users with one printer 
or aultiple printers with the same character set will find it 
convenient to permanently modify the program to have the 
appropriate SW 0 vatiue based on the following chart: | 


S¥ 0 = 0 64-character (default) 
o=- il 48-character 
GQ = 2 72Z2-character 
0 = 3 96-character 


If the vwatue of SW 0 exceeds 3» the progras will assume a 
64-character sete. | 3 | : 


Sy defauits SYSTEM/COMPARE expresses results as zerorretative 
quantities» meaning that the first bit of the first record is bit 
GC of record 0. Sose users may be accustomed to the complexity of 
thinking of numbers in a one~reiative aannerej If SW 9 is set to 
ones quantities will be sa expresseds with the abave bit example 
reflecting bit one of record onee The origin in use is printed 
as part of the error tisting heading should errors actually be 
detected. 2 
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Cosggands aust conform to the following syntax: 


> BOSE RANDMNAMAB®W|S AD > ER SD a GN GED ED GR AD GD GD GD GR GE GD GE GR GD OF GP GEE GE 4 ED 4B 01 EOD © EEE EE ODE GD EEG @& oe ee > > 


i-- <device pair specifier> -->! 


>>=— <file identifier A> ose ccs en ee cece wenn on ewe ew en nn en ennnee=->> 
i-- <record size> scoot ro osse cree =->] 
| <blocking § 
i-- factor> ~-->1 


>>-= <file identifier B> 220720 es em cee cnr 25 en ees eee eee ones er==>> 
im-- <record Sizer sere seer er ennnnm—>{ 
| a <biocking 4 
§@-- factor ~--->3 


j-- MAX Sma nanaweaem Cag ror limit> Seecseree==34 


j-- = we >j 
Valid values for <device pair specifier> include: 


OSKOSK 
. OSKCROD 
OSKTAP 
CRODSK 
CROCRD 
CROTAP 
TAPD SK 
TAPCRD 
TAPTAP 
a {the asterisk character) 


If no édevice pair specifier> is provideds OSKDSK will be used. 
The asterisk ("«*«") is the seans of instructing SYSTEM/COMPARE to 
cogapare two files sector“by~sector. <A warning messase is emitted 
tf the user specifies a record size or blocking factor for either 
file ia "sector" aode. 


<File identifier A> and <file identifier 8> are standard systen 
external file names. File nases whose first comgponent is ata 
numeric or ts equivalent to a <device pair specifier> (when none 
is specified) aust be enclosed in quotes to distinguish thes = as 
fide identifiers. 


Record sizes and biocking factors are integer valuess should the 
datter be specified» a record size aust be atso specified to 
avoid ambiguity. The biccking factor is noraaily used only for 
untabelled tapes or for biocked card files. 


| <Error tiwit> is an integer vaiue which telis SYSTEM/COMPARE to - 
terminate after that many errors are detected. fhe defauit vatue 
is 155 and the value given sust exceed zero. 
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Examples of valid input include: | 
 'TAPDSK SALES/AUGUST MASTERFILE 
a (SOURCE) /ONIKLOG BACKUPCOPY/QWKLOGSRCE 
TAPTAP UL=1 80 9 Ui-2 €0 & MAX=5 
FORTRAN RELEASE /EORTRANS 


SPO input for additional ccuparisons may be provided at any tines 
cogsmands wilt be tanked if a comparison is currently in progress. 
The following requests may also be provided at any tine: 


ST o¢ STATUS gives current record count and error count 
QUIT or ABORT tersinates current coaparison 
ciiPe closes printer file to free it for other users 


Note that the above information requests are not enqueued and are 
processed imaediateiy» whether or not additional specifications 
have been provided. 


The occurrence of a parity error on either record of a pair being 
coapared causes an informative sessage to be emitted on file LINE 
and the cosgparison of that pair to be suppressed. 
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ERROR NESSAGES 


SYSTEM/COMPARE provides 4 comprehensive set of infor#atives 
“warnings and error messages through the SPO. In cases of invatid 
operator inputs the error sessage generaily indicates the 
syntactic token that caused the prottles. The occurrence cf an 
error terg@inates a given ccaparison and the utility processes the 
next queued“~up comaand or requests new SPO inputs as appropriate. 


EATAL E8RORS 
le INCOMPATIBLE SYSTEM SOFTWARE MUST BE <level> WCP...E0U 


SYSTEM/COMPARE is concerned with certain softsare structures 
that are transparent tc users. These structures may change 
between releases» so the program sust protect itseif with 
this fatal error sessace- 


2. INSUFFICIENT DYNAMIC NEMORY TO EXECUTE SYSTEM/COMPARES RERUN 
WITH NE GEQ 4320 BITS 


SYSTEM/COMPARE wakes heavy use of dynamic memory; 4320 bits 
is necessary as a asinisgus. Note particularly that there is 
no efficiency gained by running the prograg with a higher 
value than this figure uniess sessage *6* below is emitted. 


~3e SYSTEM ERROR? VARIABLE RANDOM FILES 


Please subsit the duap that is produced and KA*s of the two 
files should this program trap be sprung. 


“RECOVERABLE ERRORS 
4. COMMAND QUEUE FULL..-SPECS IGNORED 


More than ten commands are stacked up while a conmparisen is 
in progress. In the unlikely event that this tank size is 
insufficient> file TANK may be file~equated or sodified to a 
higher value with the CUEVE.MAX MESSAGES file attribute. 


Se _ <fitenaae> IS AN EMPTY FILE 


SYSTEM/ COMPARE will not process a oon file with an EGF of 
Zeroe 


6. INSUFFICIENT OYNANIC MEMORY a COMPARE dinannne 
<filename>s RERUN WITH ME GEG <nusber> BITS 


Comparison of files with high record sizes may evoke this 
message. The vatue needed for dynasic mesory to perform a 
given coaparisen ts 16 ti@es the record size in bytes of the 
denger fite. The default Cminigua) value of 4320 bits thus. 
suffices to cospare files up te 4320/186=270 bytes in record 
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Length. Users who have frequent need to ccepare larger 


To 


7 


ae 


10. 


ii. 


record files wit probably desire to modify the progras to 
the appropriate higher ME value. : 


INTEGER EXPECTED FOR <ERROR LIMIT> AFTER "MAX® 


The Syntactic entity folloning "MAX" Cor "MAX=") was not an 
integer. | 


INTEGER EXPECTED FOR 2ND SLOCKING FACTOR 


The entity following a record size specification for the 
second file was neither the word “MAX" nor an integer. 


INTEGER EXPECTED FOR 2ND RECORD SIZE 


The syntactic entity following the second filenage specifier 
“was netther the word *MAX" nor an integer. 


"MAX" of <EMPTY> EXPECTED HERE 


Following a blocking factor specification for the second 
files an vor cenannee token was found. | 


MISSING ees (p*s 


| The user negiected to provide any input beyond the <device 


12. 


13. 


L4e 


15. 


16. 


pair specifier>. 

MISSING FINAL GUOTE IN FILE NAME 

An unmatched pair of quotation marks was founds which 
presumably were intended to delimit a file name component 
with special characters. 


MISSING 2ND FILE IC 


SYSTEM/COMPARE scannec the input specifications without 
finding other than the first file identifier. 


NAME CAN®T START WETH SLASH 


A file nase specifier erroneously started with the slash 
character. : 


NAME GTR 10 CHARACTERS 


The system peraits at aost ten characters in each cospnonent 
ef a file names SYSTEM/COMPARE enforces this digit. : 


NO FILE <fitenase> 


A disk file specified was not on disk. Note that this — 
terminates the coaparison attempt. A “no file™ condition on. 
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card or tape causes the MCP to request the appropriate file. 


17. NON“CONGRUENT AREAS ON RANDOM FILES. 
Either the patterns of allocated and unallocated areas did 
mot match on the tuo files» or the records/area differec for 
the two files. . 

18. RANDON DISK FILE <filenase> CAN BE COMPARED CALY TO ANOTHER 
RANDOM DISK FILE 
It is meaningless to try to coupare a file with interspersed 
eapty areas to a sertai type files disk or otherwise. 

19. UNRECOGNIZED TRAILING INPUT 
SYSTEM/COMPARE successfully decoded a line of operator input» 
then found unknown information when it expected to be 
through. | 

20. VARIABLE-RECORC OSN FILE <filename> CAN BE CCMPARED ONLY TO 
ANOTHER VARTABLE-RECORD DISK FILE ! 
the specialized foreaat of such records makes it itilogicat to 

| atteapt coaparison to a file with fixed length records. 

HAENINGS 

21. EXTRANEOUS GARBAGE IGNORED 
Unrecognized input occurred in a query Cnon-cosegand) AX 

220 RECORD AND/OR BLOCK SIZE SPECS IGNORED IN SECTCR MCODE 
Khen processing disk files sector -by~sector>» | the actual 
record and block sizes of those files are superfluous and 
irrelevant. {It should be noted that the MCP zero-filis the 
area between end~of-block and end-of-sectors sca the user need 
not fear invatlid coaparisons due to garbage in this unused 
portion of certain disk seguentse 

230 UNEQUAL RECORD SIZES?  €filename A>=<rsz A>} 
<filename 8>=<rsz §> 
Files to be coapared did not have identical record sizes. 
2h. VARIABLE RECORD FILES WILL BE COMPARED IN SECTCE MODE 


To eliminate special handling of variable-record disk files» 


SYSTEM/COMPARE treats them sector-by-sector uhether or not. 
*“«x" is provided as the <device pair specifier>. | | 
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JNEQRMATIVE MESSAGES 


256 


COMPARISON TERMINATED 


This eessage is the acknowledgaent of a "QUIT" or "ABDRT" 


26. 


request. | 
£0F ON <filenaae> 


The two files had differing numbers of records. 


SYSTEM/COMPARE stops a comparison when EGF on the shorter 


276 


28. 


290 


file is reached. 
ERROR LIMIT REACHED 


The specified Cor default) number of cosparison errors 
occurred before EOF was reached. 


{<a>/NO} ERRORS IN <n> CRECORDS/SECTORS) 


The results of each ccaparison are displayed. This is also 
the response to a “SI* or *STATUS" request. 


NO COMPARISON IN PROGRESS 
"ST*» “"STATUS*» "QUIT" >» or “ABORT" was entered white 


SYSTEM/COMPARE was waiting for operator input» with no- 
coaparison being performed. 7 | 
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